Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Editing Movies

CutMovieSelection

The CutMovieSelection function creates a new movie that contains the original movie's current selection. This function then removes the current selection from the original movie. After the current selection has been removed from the original movie, the duration of the current selection is 0. The starting time of the current selection is not affected.

pascal Movie CutMovieSelection (Movie theMovie); 

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

DESCRIPTION

The CutMovieSelection function returns a movie identifier. If the function could not create the new movie, it sets this returned identifier to nil.

Your application must dispose of the new movie once you are done with it. You can use the DisposeMovie function (described on page 2-83) to dispose of the new movie.

If you have assigned a progress function to the source movie, the Movie Toolbox calls that progress function during long cut operations. (For details on progress functions, see "Progress Functions" beginning on page 2-333.)

ERROR CODES

invalidMovie	-2010	This movie is corrupted or invalid
progressProcAborted	-2019	Your progress function returned an error

Memory Manager errors